I think the original goal for returning lesser information was that we want listing operations to be performant. Adding more data adds to serialization cost.

Yes, I know what you telling @diptanu , but since the endpoint returns full information I think it makes sense to get using the API client the full allocation information.

Probably nomad must allow to return the full or lesser information using some parameter being the default the summarised one, since there is already a cost converting on the servers the data to JSON.

So /node//allocations should return the []AllocationIndexStub and ?full=true (or something like that) []Allocation. That way the server and client will de/serialize the same amount of information.

Getting a summarised information forces to make 1 + n API requests instead of just 1.

Another posibility can be adding a function that like AllocationsFull returning the []Allocation and leave the current as is. In our use case the ideal is make just 1 request per server and calculate the current allocation to know if we need to spin up another node.

Thanks @fernandezvara. Could you update the documentation https://github.com/hashicorp/nomad/blob/master/website/source/docs/http/nodes.html.md.

Documentation updated.

@fernandezvara: Thanks!

I'm going to lock this pull request because it has been closed for 120 days ⏳. This helps our maintainers find and focus on the active contributions.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.